PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference

Font Name Code Constants

ATSUI identifies the type of a particular font name string by a constant of type FontNameCode. You can use one of these constants as part of your search criteria in the functions ATSUFindFontFromName and ATSUFindFontName. The function ATSUGetIndFontName passes back a constant of this type to represent the type of font name string.

The font name code identifies the type of name string that provides various kinds of information about the font, including its unique name, font family name, style, version number, and Postscript-legible name. The actual font name string varies based on the platform, script, and language of the font name. For example, the name code constant kFontCopyrightName might identify three different strings of the font manufacturer's copyright notice name, one in Unicode French, one in Macintosh English, and one in Microsoft German.

enum { kFontCopyrightName = 0, kFontFamilyName = 1, kFontStyleName = 2, kFontUniqueName = 3, kFontFullName = 4, kFontVersionName = 5, kFontPostscriptName = 6, kFontTrademarkName = 7, kFontManufacturerName = 8, kFontDesignerName = 9, kFontDescriptionName = 10, kFontVendorURLName = 11, kFontDesignerURLName = 12, kFontLicenseDescriptionName = 13, kFontLicenseInfoURLName = 14, kFontLastReservedName = 255 }; typedef UInt32 FontNameCode;

Constant descriptions

kFontCopyrightName: Identifies the font manufacturer's copyright notice name. An example of a font name string with this font name code and a platform and script of Mac Roman English is "© Apple Computer, Inc. 1993".
kFontFamilyName: Identifies the font family name, which is shared by all styles in a font family.An example of a font name string with this font name code and a platform and script of Mac Roman English is "Times".
kFontStyleName: Identifies the font style. An example of a font name string with this font name code and a platform and script of Mac Roman English is "© Apple Computer, Inc. 1993". Mac Roman English is "Regular", "Italic", "Bold", or "Black".
kFontUniqueName: Identifies the manufacturer's name for the font. Because the name identified by this constant can be used to uniquely identify the font, you should use it in stored documents and in program interchange to identify fonts. The unique name is used in the standard clipboard format. An example of a font name string with this font name code and a platform and script of Mac Roman English is "Apple Computer Times Black 3.0 8/10/92".
kFontFullName: Identifies the full font name. An example of a font name string with this font name code and a platform and script of Mac Roman English is "Times Black".
kFontVersionName: Identifies the font manufacturer's version number for the font. An example of a font name string with this font name code and a platform and script of Mac Roman English is "3.0." (The name does not need to include the word "version").
kFontPostscriptName: Identifies the PostScript-legible name of the font. This type of font name can be used to uniquely identify the font. An example of a font name string with this font name code and a platform and script of Mac Roman English is "Times-Black".
kFontTrademarkName: Identifies the font trademark name. An example of a font name string with this font name code and a platform and script of Mac Roman English is "Palatino is a registered trademark of Linotype AG".
kFontManufacturerName: Identifies the font manufacturer's name. An example of a font name string with this font name code and a platform and script of Mac Roman English is "Apple Computer, Inc."
kFontDesignerName: Identifies the font family designer's name.
kFontDescriptionName: Identifies the description of the font family.
kFontVendorURLName: Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.
kFontDesignerURLName: Identifies the uniform resource locator of the font family designer.
kFontLicenseDescriptionName: Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.
kFontLicenseInfoURLName: Identifies the uniform resource locator of the font vendor. If a unique serial number is embedded in the URL, it can be used to register the font.
kFontLastReservedName: Identifies the maximum value for Apple-defined font name codes. You can pass values between kFontLicenseInfoURLName and kFontLastReservedName to find the name of a font variation axis, font feature, font tracking setting, or font instance.